From e836e3380e1f2a78010c8caa530b449212075469 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 20 Jun 2023 06:53:34 -0400 Subject: [PATCH] Add a comment about accessible naming Put a note on why there are a few differences to ARIA. --- gtk/gtkatcontext.c | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/gtk/gtkatcontext.c b/gtk/gtkatcontext.c index 42f0c2717e..efbc572665 100644 --- a/gtk/gtkatcontext.c +++ b/gtk/gtkatcontext.c @@ -1010,7 +1010,12 @@ gtk_at_context_get_accessible_relation (GtkATContext *self, /* See ARIA 5.2.8.4, 5.2.8.5 and 5.2.8.6 for the prohibited, from author * and from content parts, and the table in * https://www.w3.org/WAI/ARIA/apg/practices/names-and-descriptions/ - * for the recommended / not recommended parts. + * for the recommended / not recommended parts. We've made a few changes + * to the recommendations: + * - We don't recommend against labelling listitems, sincd GtkListView + * will put the focus on listitems sometimes. + * - We don't recommend tab lists being labelled, since GtkNotebook does + * not have a practical way of doing that. */ #define NAME_FROM_AUTHOR (1 << 6) -- 2.30.2